home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / ENGINEER / 4018.ZIP / WASPBOOK.DOC < prev    next >
Text File  |  1993-11-10  |  52KB  |  1,218 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                       W A S P
  12.                                       =======
  13.  
  14.  
  15.  
  16.                             Water and Steam Properties
  17.                             ==========================
  18.  
  19.  
  20.  
  21.                            Version 1.01    November 1993
  22.  
  23.  
  24.                              Copyright (C) 1992, 1993
  25.                                 All rights reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                   Katmar Software
  33.                                     PO Box 654
  34.                                      Westville
  35.                                        3630
  36.                                    South Africa
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.        DISCLAIMER
  53.        ----------
  54.  
  55.        The WASP programme and documentation are supplied as is.  Katmar
  56.        Software disclaims all warranties, expressed or implied, including
  57.        but not limited to, the warranties of merchantability and of fitness
  58.        for any purpose.  Katmar Software and the programme author assume no
  59.        liability for damages, direct or consequential, which may result
  60.        from the use of WASP.
  61.  
  62.  
  63.  
  64.  
  65.                                  TABLE OF CONTENTS
  66.                                  -----------------
  67.  
  68.  
  69.  
  70.  
  71.  
  72.        Introduction to WASP  . . . . . . . . . . . . . . . . . . . . .    1
  73.  
  74.        Installation and Startup  . . . . . . . . . . . . . . . . . . .    1
  75.  
  76.        Hardware and Software Requirements  . . . . . . . . . . . . . .    2
  77.  
  78.        Quick Start for Experienced Users . . . . . . . . . . . . . . .    3
  79.  
  80.        Printing the Manual . . . . . . . . . . . . . . . . . . . . . .    4
  81.  
  82.        Detailed Operating Instructions . . . . . . . . . . . . . . . .    4
  83.             Start-up . . . . . . . . . . . . . . . . . . . . . . . . .    4
  84.             On-line Help System  . . . . . . . . . . . . . . . . . . .    4
  85.             Data Entry . . . . . . . . . . . . . . . . . . . . . . . .    5
  86.             Result Screens . . . . . . . . . . . . . . . . . . . . . .    6
  87.             Fixed Properties . . . . . . . . . . . . . . . . . . . . .    7
  88.             Selecting Units  . . . . . . . . . . . . . . . . . . . . .    7
  89.             Using the Menus  . . . . . . . . . . . . . . . . . . . . .    8
  90.             Exiting from WASP  . . . . . . . . . . . . . . . . . . . .    8
  91.  
  92.        Accuracy Considerations . . . . . . . . . . . . . . . . . . . .    9
  93.  
  94.        The Shareware Distribution System . . . . . . . . . . . . . . .   11
  95.  
  96.        WASP Licensing Policy . . . . . . . . . . . . . . . . . . . . .   12
  97.             Registration to Engineering Schools  . . . . . . . . . . .   14
  98.  
  99.        Bug Reports and Wish Lists  . . . . . . . . . . . . . . . . . .   14
  100.  
  101.        Other Engineering Packages from Katmar Software . . . . . . . .   15
  102.  
  103.        Appendix  . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  104.             WASP Registration Form . . . . . . . . . . . . . . . . . .   15
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.        Water and Steam Properties - Version 1.01                    Page i
  123.  
  124.  
  125.  
  126.        Introduction to WASP
  127.        ====================
  128.  
  129.        WASP is a replacement for traditional printed Steam Tables, but it
  130.        goes further in that it provides a much wider set of properties, it
  131.        eliminates the need for interpolating between data points, and it
  132.        will work in any of the generally accepted units.
  133.  
  134.        It contains data for 15 point properties, and 17 temperature and
  135.        pressure dependent properties.  Most of the correlations cover the
  136.        range from -100  C to 800  C and up to 1000 bar, and some extend
  137.        even beyond this range.  Calculated data points match published 
  138.        data very closely.
  139.  
  140.        The programme has been carefully designed for speed and ease of use. 
  141.        On-screen prompts appear at every step to guide you. In addition
  142.        there is context sensitive, on-line Help available at all times. If
  143.        you are ever unsure of what the programme expects you to do, simply
  144.        pressing the <F1> key will open a window with detailed instructions
  145.        and information. You can also view any Help Screen at any time by
  146.        selecting it from a Help Index.
  147.  
  148.        WASP is distributed as Shareware.  If this copy is registered to
  149.        anyone other than yourself,  you are entitled to use it for a few
  150.        weeks to determine its value to you.  If you continue to use the
  151.        programme then you must register your copy with Katmar Software.
  152.        Further details on Shareware and the registration procedure are
  153.        given later in this manual.
  154.  
  155.  
  156.        Installation and Startup
  157.        ========================
  158.  
  159.        You should not use the distribution disk that you received as a
  160.        working disk.  You should install the WASP package to either another
  161.        diskette or to your hard disk.
  162.  
  163.        Installation of WASP entails simply copying all the files to either
  164.        a diskette or to your hard disk.  The distribution disk that you
  165.        received should contain all of the following files :-
  166.  
  167.             GETRESP.EXE      Utility for interactive batch files
  168.             PAGE.COM         Text file display utility
  169.             README           Brief details on WASP and its distribution
  170.             README.BAT       A batch file used to display or print README
  171.             REGISTER.DOC     Order form for registering your copy of WASP
  172.             WASP.EXE         The executable file for WASP
  173.             WASPBOOK.DOC     The instruction manual for the WASP package
  174.             WASPDEFS.DTA     Holds the selected units etc
  175.             WASPHELP.HLP     The on-line help instructions
  176.  
  177.        If instead of these files your disk contains a file named
  178.        WASP101.ARC, WASP101.ZIP or some similar name then it means that the
  179.        disk distributor has compressed the files into an archive file to
  180.        get more onto the distribution disk.  In this case you will need to
  181.  
  182.  
  183.        Water and Steam Properties - Version 1.01                    Page 1
  184.  
  185.  
  186.  
  187.        follow the distributors instructions on how to extract the files
  188.        from the archive before you can copy them.
  189.  
  190.        If you are installing to your hard disk you should copy the files to
  191.        a separate sub-directory.  To create a new sub-directory on your
  192.        hard drive follow these steps :-
  193.  
  194.            1)  Ensure that you are at the DOS prompt, ie display shows C:>
  195.                (if your hard drive is drive D display shows D:> , etc)
  196.            2)  If you want the new sub-directory to be off the root
  197.                directory, type CD\ and press <ENTER>.  If you prefer the 
  198.                new sub-directory to be off some other directory, change to
  199.                that directory.
  200.            3)  Type MD WASP and press <ENTER>.
  201.            4)  Type CD WASP and press <ENTER>.  Display should show
  202.                C:\WASP>. If display does not show this, type PROMPT $P$G
  203.                and press <ENTER>.
  204.  
  205.        If your distribution disk contains all the files listed above,
  206.        insert it into the A drive and type COPY A:*.* and press <ENTER>.    
  207.        The programme is then ready to run.  If your distribution disk does
  208.        not contain all the files listed above, but instead contains an
  209.        archived file, copy that file to the new sub-directory (eg COPY
  210.        A:WASP101.ZIP).  Then follow the distributors instructions to
  211.        un-archive the files.
  212.  
  213.        Once the files have been copied you should type WASP and press
  214.        <ENTER> to start the programme.  The programme starts with an
  215.        opening screen and then a screen giving brief details of the
  216.        shareware distribution system, before getting to the programme
  217.        proper.  The initial screens can be skipped by pressing the
  218.        <SPACE BAR>.
  219.  
  220.        If you are short of space on your hard disk you can delete some of
  221.        the files.  Only two files are absolutely essential for running
  222.        WASP.  These are WASP.EXE and WASPDEFS.DTA.  If you want to be able
  223.        to use the on-line help facility you will also need the file
  224.        WASPHELP.HLP, but the programme can run without it.  When you pass
  225.        on copies of WASP to others please always include all the files on
  226.        the distribution disk so that the recipient can make a full
  227.        evaluation of the package.
  228.  
  229.  
  230.        Hardware and Software Requirements
  231.        ==================================
  232.  
  233.        WASP will run on virtually any IBM(tm) PC or compatible machine.  It
  234.        has been designed to be able to be used on a minimum specification
  235.        system, but also to make use of higher specification equipment if
  236.        available.  For example it will run perfectly well on a monochrome
  237.        screen, but will switch to colour if it detects a colour video card.
  238.        Similarly it will use a numeric co-processor if it finds one, but
  239.        will run quite happily (although of course more slowly) if none is
  240.        found.
  241.  
  242.  
  243.  
  244.        Water and Steam Properties - Version 1.01                    Page 2
  245.  
  246.  
  247.  
  248.        Some EGA and VGA displays, particularly on portable computers, use
  249.        varying shades of grey rather than true colour.  WASP would detect
  250.        these machines as having colour screens and you may have some
  251.        difficulty reading the display.  In this case you can force the
  252.        programme to use the monochrome palette by pressing <Alt M> at the
  253.        opening screen or by using the /M command line switch i.e. start the
  254.        programme by typing WASP /M.  When you exit from the programme it
  255.        will store this choice and start up in monochrome mode the next time
  256.        you use it.
  257.  
  258.        Summary of system requirements :-
  259.             DOS   :  2.11 or later
  260.             RAM   :  512k or more
  261.             DISK  :  360k or larger floppy, stiffy or hard disk
  262.             VIDEO :  Monochrome, CGA, EGA, VGA or compatible
  263.             Co-processor :  Optional
  264.  
  265.  
  266.        Quick Start for Experienced Users
  267.        =================================
  268.  
  269.        Even if you are only a moderately experienced computer user you
  270.        should be able to use WASP without going into this manual in any
  271.        depth at all.  The brief instructions that follow in this section
  272.        should be all you need to make full use of the programme.  The
  273.        programme will guide you with on-screen prompts at every stage and
  274.        on-line help is always available by pressing <F1>.
  275.  
  276.        The programme is started by typing WASP, or WASP /M if you want to
  277.        force monochrome mode on a colour screen.  The opening screens can
  278.        be skipped by pressing the <SPACE BAR> or virtually any other key.  
  279.  
  280.        After the opening screens you will see the DATA ENTRY screen.  This
  281.        is where you specify the conditions under which you want the
  282.        physical properties calculated.  In the general case you will enter
  283.        the temperature and pressure, pressing <ENTER> after each entry. 
  284.        For the specific case of saturated conditions you need to enter
  285.        either the temperature or the pressure, but not both.  In this case
  286.        you can use <TAB> to ensure that the property you want to enter is
  287.        on the top line in the box and then key in the value.  After typing
  288.        the value, press <SPACE BAR> instead of <ENTER> and the programme
  289.        will calculate the corresponding value for saturated conditions.
  290.  
  291.        During data entry the editing keys work in a very standard way, and
  292.        should not give you any trouble at all.  If there is already a value
  293.        in the entry field you can accept it by pressing <ENTER> or <SPACE
  294.        BAR>.  If you want to enter a completely different value just start
  295.        typing and the original value will disappear.  However if the first
  296.        key you press is an <ARROW> key the programme will assume you want
  297.        to edit the displayed value and will not clear it.
  298.  
  299.        After you have specified the conditions the programme will calculate
  300.        the properties and display them.  There are two forms for the result
  301.        screens.  These are a brief and a full format screen.  You can
  302.        toggle between the two by pressing <F2>.
  303.  
  304.  
  305.        Water and Steam Properties - Version 1.01                    Page 3
  306.  
  307.  
  308.  
  309.        While either the DATA ENTRY or RESULT screen is displayed you can
  310.        call up a list of fixed properties with the <F3> key.  Pressing <F3>
  311.        again will take you back to where you were.
  312.  
  313.        The units in which you specify the conditions, and in which the
  314.        properties are displayed, can be changed with the <F4> key.  The
  315.        units can be selected in pre-defined sets, or individually if you
  316.        want to mix systems of units.
  317.  
  318.  
  319.        Printing the Manual
  320.        ===================
  321.  
  322.        If you are reading this on your screen and you want to make a hard
  323.        copy on your printer you can do it in one of two ways.  The easiest
  324.        way is to run the programme and then press <Alt P> at the opening
  325.        screen.  The other way is to type PRINT WASPBOOK.DOC at the DOS
  326.        prompt.
  327.  
  328.  
  329.        Detailed Operating Instructions
  330.        ===============================
  331.  
  332.        This section gives full details for each step of using the
  333.        programme.  
  334.  
  335.  
  336.        Start-up
  337.        --------
  338.  
  339.        If you are running WASP from the DOS prompt (eg C:\>) it will be
  340.        necessary to change to the directory into which you copied the
  341.        files.  You should then type WASP and press <ENTER> to start the
  342.        programme.  If you want to force a colour video card to display in
  343.        monochrome you can start the programme with the WASP /M command.  If
  344.        you are using a hard disk manager or menu system all this should be
  345.        automated into the menu.
  346.  
  347.        When the programme starts it will display the opening screen with
  348.        the version and copyright information.  After a while it will skip
  349.        to the shareware distribution notice screen.  Both of these screens
  350.        can be skipped by pressing <SPACE BAR> or <ENTER>.
  351.  
  352.        If you have a colour video card but a monochrome screen, as is often
  353.        the case with portable computers, you may have problems reading the
  354.        screen.  If this is the case, press <Alt M> to switch to the
  355.        monochrome colour scheme.
  356.  
  357.  
  358.        On-line Help System
  359.        -------------------
  360.  
  361.        At any stage during the running of the programme you can press <F1>
  362.        and get help on the specific item on which you are working.  Once
  363.        you are in the Help window you will see in the top right corner the
  364.  
  365.  
  366.        Water and Steam Properties - Version 1.01                    Page 4
  367.  
  368.  
  369.  
  370.        message  "Page x of y".  If there is more than one page of help
  371.        available you can page through the help windows by pressing PgUp,
  372.        PgDn, Home and End.  The message in the bottom right corner tells
  373.        you whether you can page up or down.  There will also be flashing
  374.        arrows on the right hand side that show if there is more data above
  375.        or below the current page.
  376.  
  377.        If you press <F1> while a help screen is being displayed you will be
  378.        shown an index of all the help available for this programme.  From
  379.        this index you can select any one of the help topics that are
  380.        available.  Simply use the <Arrow> and <Page> keys to highlight the
  381.        topic on which you want help, and press <ENTER>.
  382.  
  383.        After you have read that help topic you can return to the Help Index
  384.        by pressing <F1> again. You can switch back and forth like this as
  385.        often as you like.
  386.  
  387.        When you have read all the help you want, you can return to where
  388.        you left the programme by pressing <Esc>.
  389.  
  390.  
  391.        Data Entry
  392.        ----------
  393.  
  394.        The Data Entry screen allows you to specify the temperature and
  395.        pressure at which the physical properties will be calculated.  This
  396.        can be done in several ways, described below.
  397.  
  398.        Apart from specifying these conditions there are other options
  399.        available on the Data Entry screen. Pressing <F3> will display the
  400.        physical properties that do not vary with temperature or pressure.
  401.        Pressing <F4> allows you to specify the units in which your entry is
  402.        made, and in which the properties will be displayed.  If you have a
  403.        colour video card <Alt C> and <Alt M> will switch between colour and
  404.        monochrome.  If you want to exit WASP press <Alt X>.
  405.  
  406.        If you want to calculate the physical properties under SATURATED
  407.        solid/vapour or liquid/vapour conditions you need to specify either
  408.        the temperature or pressure, but not both.  The entry must be made
  409.        on the top line and the <TAB> key is used to select which of these
  410.        you will enter.  For example, if the programme is requesting you to
  411.        enter the temperature on the top line of the input box, but you want
  412.        to specify the pressure, press <TAB> to swop the two lines.
  413.  
  414.        Under saturated conditions it is not necessary to press <ENTER>
  415.        after you have keyed in the number.  Just press the <SPACE BAR> and
  416.        the corresponding value will be inserted and the properties will be
  417.        calculated.
  418.  
  419.        In order to calculate the physical properties at conditions other
  420.        than saturated, you have to specify both the temperature and the
  421.        pressure.  You can swop the two entry lines with <TAB>, and you can
  422.        move the cursor from one line to the other with the up and down
  423.        arrow keys.  When you have keyed in the value on the bottom line
  424.        pressing <ENTER> will calculate the physical properties.
  425.  
  426.  
  427.        Water and Steam Properties - Version 1.01                    Page 5
  428.  
  429.  
  430.  
  431.        As you enter the conditions the programme will check that they fall
  432.        in the range covered by the data.  If they are not valid entries,
  433.        the allowable range will be displayed at the bottom of the screen in
  434.        the units selected, and you will be asked to re-enter the value. 
  435.        The allowable temperature range is from 166 to 1273 Kelvin (-160 to
  436.        1832 Fahrenheit) and the allowable pressure range is from 3.4e-7 to
  437.        100 000 kPa absolute (4.9e-8 to 14500 PSI absolute).
  438.  
  439.        During data entry the left and right arrow keys, and the <HOME> and
  440.        <END> keys, allow you to move the cursor back and forth within the
  441.        entry field.  The <DELETE> key deletes the character under the
  442.        cursor and the <BACKSPACE> key deletes the character to the left of
  443.        the cursor.  <Ctrl BACKSPACE> will delete the entire entry field.
  444.  
  445.        If the entry field already contains a number and you press a numeric
  446.        key before any of the editing keys, the programme will assume that
  447.        you want to override the original entry and will delete it before
  448.        displaying the character you have keyed. If you want to accept what
  449.        is already displayed just press <ENTER> or <SPACE BAR>, depending on
  450.        whether you are working under saturated conditions or not.
  451.  
  452.        Data entry always works in INSERT mode, i.e. characters under and to
  453.        the right of the cursor will be moved to make space for the new
  454.        character.
  455.  
  456.        Only numeric characters will be accepted, except that <e> can be
  457.        used to signify exponential notation.  E.g. the value 2000 can be
  458.        entered as 2e3,  and 0.001 can be entered as 1e-3.
  459.  
  460.  
  461.        Result Screens
  462.        --------------
  463.  
  464.        There are several different formats for the result screens that
  465.        display the physical properties.  The format of these screens varies
  466.        according to the phases that are present, and according to the
  467.        choices that you have made.  However, all screens follow the same
  468.        basic pattern.
  469.  
  470.        The highlighted box at the top of the screen shows the temperature
  471.        and pressure that you specified and also shows the phases that will
  472.        be present.
  473.  
  474.        The main result box in the centre of the screen gives all the
  475.        physical properties, the units and the values for each phase.  Every
  476.        alternate line in this box is highlighted to make it easier to
  477.        follow the line across the screen.
  478.  
  479.        The bottom line of the result box shows some of the options
  480.        available.  If you press <Esc>, or in fact any alphanumeric key, you
  481.        will be returned to the Data Entry screen.
  482.  
  483.        The <F2> function key toggles between the full and brief versions of
  484.        the output screens.  The brief results screen gives the properties
  485.        usually found in "Steam Tables".  The full screen gives the same
  486.  
  487.  
  488.        Water and Steam Properties - Version 1.01                    Page 6
  489.  
  490.  
  491.  
  492.        information plus the less frequently needed properties.  The brief
  493.        screen is easier to use because it contains less information.
  494.  
  495.        When you exit from WASP the programme will make a note of which
  496.        result screen you had chosen, and will use this choice when it is
  497.        re-started.
  498.  
  499.        Although it is not shown in the list of options you can use the <F3>
  500.        function key to display the fixed physical properties. The <F4> key
  501.        allows you to choose the units in which the properties are
  502.        displayed.  You can select standard sets of units, or choose the
  503.        units for each property individually.  Further information on making
  504.        these choices is available in the section on Selecting Units below.
  505.  
  506.        If you have a colour video card pressing <Alt C> and <Alt M> will
  507.        switch between colour and monochrome output. You can exit from WASP
  508.        by pressing <Alt X>.
  509.  
  510.  
  511.        Fixed Properties
  512.        ----------------
  513.  
  514.        The physical properties of water that do not vary with temperature
  515.        or pressure can be displayed by pressing <F3> at the Data Entry
  516.        Screen or at the Result Screen displaying the variable properties.
  517.  
  518.        The main result box in the centre of the screen gives all the
  519.        physical properties, the units used and the values for each physical
  520.        property.  Every alternate line in this box is highlighted to make
  521.        it easier to follow the line across the screen.
  522.  
  523.        The bottom line of the result box shows some of the options
  524.        available.  If you press <Esc> or <F3> you will be returned to the
  525.        screen from where you requested the fixed properties.
  526.  
  527.        The <F4> key allows you to choose the units in which the properties
  528.        are displayed.  You can select standard sets of units, or choose the
  529.        units for each property individually.  Further Help on making these
  530.        choices is available in the section on Selecting Units below.
  531.  
  532.        If you have a colour video card pressing <Alt C> and <Alt M> will
  533.        switch between colour and monochrome output.  You can exit from WASP
  534.        by pressing <Alt X>.
  535.  
  536.  
  537.        Selecting Units
  538.        ---------------
  539.  
  540.        The units that are used for data entry and for displaying the
  541.        physical properties can be chosen in sets, or individually for each
  542.        property.  The first 5 options on the menu select the sets of units
  543.        and the balance of the options are for the individual units.
  544.  
  545.        There are two ways to make a selection from the menu.  The first is
  546.        the "Point-and-Shoot" method.  Use the arrow keys to highlight your
  547.  
  548.  
  549.        Water and Steam Properties - Version 1.01                    Page 7
  550.  
  551.  
  552.  
  553.        choice, and then press <ENTER>.  The second method is faster,
  554.        requiring only a single key press.  Simply press the alphabetic key
  555.        corresponding to your choice.
  556.  
  557.        You can see which units are currently selected by pressing
  558.        <SPACE BAR> while the menu is displayed.
  559.  
  560.        If you select one of the sets of units, the programme will display
  561.        the units that will be used for each property.  Press <Esc> to get
  562.        back to the menu, and again to get back to the point from where you
  563.        called the Units menu.
  564.  
  565.        When you choose to change the units for an individual property you
  566.        will be shown a sub-menu with the available units.  In the sub-menu
  567.        the currently selected unit will be highlighted.  The method for
  568.        selecting the option from the sub-menu is exactly the same as for
  569.        the main menu.  After you make your selection the programme will
  570.        automatically return to the main menu, from where you can choose to
  571.        change the units for another property, or you can press <Esc> to
  572.        quit the menu.
  573.  
  574.        The only individual unit that needs further explanation is option
  575.        "H", ie Density / Specific Volume.  Strictly speaking density and
  576.        specific volume are not the same property, but in WASP they are
  577.        dealt with together as the one is just the reciprocal of the other.
  578.  
  579.        Whenever you exit from WASP, the programme will check to see if the
  580.        selected units have changed. If they have, it will give you the
  581.        option of saving the new selection of units for use in the next
  582.        session.  You can revert to the last saved selection of units at any
  583.        stage during a session by selecting the first option on the units
  584.        menu.
  585.  
  586.  
  587.        Using the Menus
  588.        ---------------
  589.  
  590.        All the menus in WASP follow exactly the same format. There are
  591.        three ways to make a selection from a menu.
  592.  
  593.        The first is the "Point-and-Shoot" method. Use the arrow keys to
  594.        highlight your choice, and then press <ENTER>.  The second method is
  595.        basically the same as the first, except that the mouse is used to
  596.        highlight the choice.  The left mouse button functions as an <ENTER>
  597.        key and the right button as an <Esc> key.
  598.  
  599.        The third method is the fastest, requiring only a single key press. 
  600.        Simply press the alphanumeric key corresponding to your choice.
  601.  
  602.  
  603.        Exiting from WASP
  604.        -----------------
  605.  
  606.        When you want to exit from WASP press <Alt X>.  As the programme
  607.        quits it will check to see if the selection of units to be used has
  608.  
  609.  
  610.        Water and Steam Properties - Version 1.01                    Page 8
  611.  
  612.  
  613.  
  614.        been changed from what it was at the start of the session.  If the
  615.        selection was changed, the programme will request you to confirm
  616.        whether you want it to start up the next session with the new units,
  617.        or with the same selection as the current session did.
  618.  
  619.        The programme will also save your current selection of full or brief
  620.        result screen output, and whether you were using the colour or
  621.        monochrome display.  These selections are saved automatically and
  622.        you will not be prompted to confirm that you want them saved.
  623.  
  624.  
  625.        Accuracy Considerations
  626.        =======================
  627.  
  628.        The accuracies listed below are given in good faith and reflect our
  629.        testing of the WASP correlations against a wide range of sources. 
  630.        We believe that the accuracies attained are well within the bounds
  631.        normally required for process engineering design work, but if you
  632.        are doing very exacting calculations (particularly if they are near
  633.        the critical point) you should cross check your data.
  634.  
  635.        This cross checking of data is good engineering practice for
  636.        important design work and its necessity was brought home to us in no
  637.        uncertain way during the testing of WASP.  We found several
  638.        typographical errors in well known data sources and some of the data
  639.        tables were just plain wrong.  There are probably quite a few
  640.        installations around the world that were designed using this data !
  641.  
  642.        There are accuracy advantages in using a package like WASP in that
  643.        you will avoid the typo's in the published tables, you will get
  644.        better interpolations between the published data points and you will
  645.        not be exposed to the risk of arithmetical errors in converting to
  646.        different units.
  647.  
  648.        The "worst" errors are the worst that we found, and in general were
  649.        near the critical point.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.        Water and Steam Properties - Version 1.01                    Page 9
  672.  
  673.  
  674.  
  675.           PROPERTY                         TYPICAL ERROR      "WORST" ERROR
  676.  
  677.           Enthalpy
  678.             Solid                              0.002 %            0.01 %  
  679.             Saturated Liquid                   0.03 %             0.3 %
  680.             Sub-cooled Liquid                  0.5 %              3.0 %
  681.             Saturated Vapour                   0.04 %             0.5 %
  682.             Superheated Vapour                 0.04 %             0.5 %
  683.             Supercritical Vapour               0.4 %              4.3 %
  684.  
  685.           Enthalpy of Vapourisation
  686.             Solid                              0.001 %            0.01 %
  687.             Liquid                             0.04 %             0.4 %
  688.  
  689.           Entropy
  690.             Solid                              0.01 %             0.02 %
  691.             Saturated Liquid                   0.05 %             0.8 %
  692.             Sub-cooled Liquid                  0.3 %              3.0 %
  693.             Saturated Vapour                   0.01 %             0.02 %
  694.             Superheated Vapour                 0.1 %              2.0 %
  695.             Supercritical Vapour               0.2 %              2.3 %
  696.  
  697.           Density
  698.             Solid                              0.02 %             0.03 %
  699.             Saturated Liquid                   0.01 %             0.06 %
  700.             Sub-cooled Liquid                  0.2 %              2.7 %
  701.             Saturated Vapour                   0.04 %             0.4 %
  702.             Superheated Vapour                 0.04 %             0.4 %
  703.             Supercritical Vapour               0.3 %              12.1 %
  704.  
  705.           Saturation Pressure                  0.02 %             0.05 %
  706.           Saturation Temperature               0.008 K            0.02 K
  707.  
  708.           Viscosity
  709.             Saturated Liquid                   0.1 %              0.8 %
  710.             Sub-cooled Liquid                  0.6 %              9.7 %
  711.             Saturated Vapour                   0.2 %              0.8 %
  712.             Superheated Vapour                 0.5 %              4.0 %
  713.             Supercritical Vapour               0.5 %              15.0 %
  714.  
  715.           Heat Capacity
  716.             Solid                              0.2 %              1.0 %
  717.             Liquid                             0.3 %              3.0 %
  718.             Saturated Vapour                   0.1 %              0.2 %
  719.             Superheated Vapour                 0.1 %              1.0 %
  720.             Supercritical Vapour               0.5 %              8.0 %
  721.  
  722.           Thermal Conductivity
  723.             Liquid                             0.2 %              0.9 %
  724.             Saturated Vapour                   0.8 %              2.5 %
  725.             Superheated Vapour                 1.3 %              12.0 %
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.        Water and Steam Properties - Version 1.01                    Page 10
  733.  
  734.  
  735.  
  736.           PROPERTY                         TYPICAL ERROR      "WORST" ERROR
  737.  
  738.           Surface Tension                      0.3 %              2.0 %
  739.  
  740.           Isothermal Compressibility
  741.             Liquid                             2.5 %              9.3 %
  742.  
  743.           Dielectric Constant                  0.04 %             0.6 %
  744.           Refractive Index of Liquid           0.002 %            0.004 %
  745.           Boiling Point                        0.008 K            0.02 K
  746.           Isentropic Expansion Coefficient     0.001              0.005
  747.  
  748.  
  749.  
  750.  
  751.        The Shareware Distribution System
  752.        =================================
  753.  
  754.        Although shareware is often thought of as a type of software, it is
  755.        actually a form of software distribution.  This section gives
  756.        details on the shareware system and how it works.
  757.  
  758.        The Shareware distribution system can be seen as having developed
  759.        naturally in the environment of free enterprise and innovation that
  760.        characterised the PC industry in the early 1980's.  It has continued
  761.        to grow and today there is a huge variety of high quality software
  762.        available at reasonable prices.  Shareware in fact covers a wider
  763.        range of subjects than commercial software.  Some of the areas that
  764.        are particularly well represented are databases, word processors,
  765.        spreadsheets, CAD, games, DOS utilities, menuing systems, education,
  766.        accounting and programming support.
  767.  
  768.        A support industry that includes magazines, disk distributors and
  769.        bulletin board systems has grown up around the Shareware system.
  770.  
  771.        If you are new to Shareware you may like to have a look at some of
  772.        the software available from the disk distributors.  They supply
  773.        evaluation copies of Shareware packages for about US$10.00 per disk.
  774.        This payment is for copying the software and the price of the disk,
  775.        and  NOT  for the software itself. If you like the software you send
  776.        your payment to the author and not to the distributor.
  777.  
  778.        Some distributors with good catalogues are :-
  779.  
  780.           1  Public Brand Software, Box 51315, Indianapolis,
  781.              IN 46241, United States of America.
  782.           2  The Public Domain and Shareware Library,
  783.              Winscombe House, Beacon Rd, Crowborough,
  784.              Sussex, TN6 1UL, England.
  785.           3  JSE, 73 Highway, Fish Hoek, 7975, South Africa.
  786.  
  787.        The basic concept of Shareware is that the author retains the
  788.        copyright and all other commercial rights to the software and
  789.        documentation, while allowing, and indeed encouraging, wide copying
  790.        and distribution of the package.
  791.  
  792.  
  793.        Water and Steam Properties - Version 1.01                    Page 11
  794.  
  795.  
  796.  
  797.        There are a few restrictions that authors place on distribution. 
  798.        All copies must be full copies of the entire package with no
  799.        modifications or additions.  Copies may not be sold for more than
  800.        the cost of the disk, the labour of copying and a reasonable profit. 
  801.        When selling copies the distributor must state that the software is
  802.        free for evaluation purposes only and payment must be made to the
  803.        author if continued use is made of the programme.
  804.  
  805.        Effectively the Shareware author is relying on the users of his
  806.        software to do his marketing.  For this reason Shareware is often
  807.        also called User Supported Software.  This system eliminates almost
  808.        all the advertising and marketing costs that make up the major
  809.        portion of the operating budgets of commercial software
  810.        distributors.
  811.  
  812.        There are many advantages in Shareware to users and authors.  The
  813.        cost to the user is low because no money is wasted on advertising
  814.        and fancy packaging that add no real value to the software.  The
  815.        biggest advantage to the user is that it is a true
  816.        "try-before-you-buy" system.  The software can be fully evaluated on
  817.        the user's hardware and in his own environment before payment is
  818.        made.
  819.  
  820.        Another advantage to the user is that by its very nature Shareware
  821.        cannot be copy protected. This eliminates the hassle of key disks,
  822.        dongles, immovable sectors on hard disks, special install and
  823.        uninstall routines and all the other wonderful schemes that have
  824.        been devised to try the user's patience.
  825.  
  826.        As there is no middleman (middlemen ?) not only is the cost kept
  827.        lower, but the user is also closer to the author and is able to
  828.        write directly to him for help and advice.  Shareware authors
  829.        generally encourage users to send in "wish-lists" of desired
  830.        features, and are quite responsive to those requests.
  831.  
  832.        There are of course also advantages to the authors who use Shareware
  833.        to distribute their products.  The cost of launching a new product
  834.        via Shareware is much less than via normal commercial channels. 
  835.        This has allowed smaller software houses to market innovative and
  836.        highly specialised software that would otherwise simply not be
  837.        profitable. Running costs are also lower as there are almost no
  838.        marketing or advertising costs.
  839.  
  840.        The software industry is currently going through a consolidation
  841.        phase with the big-boys buying each other, and some of the smaller
  842.        boys, out.  But a significant number of the small companies have
  843.        switched to Shareware and have made some really top class software
  844.        available via this route.
  845.  
  846.  
  847.        WASP Licensing Policy
  848.        =====================
  849.  
  850.        This section describes the WASP licensing policy.  The WASP licence
  851.        agreement is basically the usual Shareware policy.  Recipients of
  852.  
  853.  
  854.        Water and Steam Properties - Version 1.01                    Page 12
  855.  
  856.  
  857.  
  858.        copies of the WASP package are requested to use the system for a few
  859.        weeks to determine its value.  You only need to pay for it if you
  860.        believe that it offers the value of the asking price.  If it does
  861.        not meet your needs or standards then it costs you nothing.  WASP
  862.        can be bought either as a single-user system for US$ 40.00 or as a
  863.        multi-user site licence for US$ 75.00 (or the equivalents in SA
  864.        Rands).
  865.  
  866.        The single-user licence entitles you to install the package onto
  867.        several different computers on a single site, provided that it is
  868.        not run on more than one machine at a time.  If it is likely that it
  869.        will be run simultaneously on two or more machines we request that
  870.        you purchase a site licence.
  871.  
  872.        You can register your copy of WASP by either filling in the
  873.        registration form in the file REGISTER.DOC or by pressing <Alt R> at
  874.        the Shareware Distribution screen and answering the questions.  This
  875.        will print the completed form on your printer.  If you use the
  876.        REGISTER.DOC file you can print it out and fill it in manually, or
  877.        load it into your word processor for completion.  A copy of
  878.        REGISTER.DOC is attached to the end of this manual.
  879.  
  880.        In return for your registration fee we will send you a copy of the
  881.        latest version of WASP with your company's name listed as the
  882.        licence holder on the title screen.
  883.  
  884.        We do not send printed copies of the manual to purchasers of WASP. 
  885.        Instead there will be a file containing the manual on the disk for
  886.        you to print out (just like this manual).  This is done for three
  887.        reasons.  Firstly it keeps the price down, secondly it allows
  888.        revisions and improvements to be included immediately rather than
  889.        having to run down stocks of old manuals, and thirdly we believe
  890.        that well-written software should not need a manual !   What is your
  891.        attitude to manuals ?  Do you read them ?  Please let us know if you
  892.        feel a printed copy is important.
  893.  
  894.        What else do you get for being honest and sending in your
  895.        registration fee ?  Well, we can't promise to fill your mail box
  896.        with junk mail, but if you don't register we have no way of telling
  897.        you of updates and of our other software products.
  898.  
  899.        Registered users are also entitled to support by mail.  If you have
  900.        any problems please write and we will do our best to help.  We would
  901.        also like to hear of any features you would like to see added to
  902.        WASP.  Are there units that you use that we have not built in ?  
  903.        Let us know and if they are anything more reasonable than
  904.        bathtubs/fortnight we will build them in.  Are there standard
  905.        calculations that you would like built in ?  If so please send
  906.        details and samples. 
  907.  
  908.        Whether you register or not, may we request that you give away
  909.        copies of WASP to your friends, colleagues, customers, suppliers,
  910.        students and anyone else who would have a use for it.  We would also
  911.        appreciate it if copies are uploaded to BBSs.
  912.  
  913.  
  914.  
  915.        Water and Steam Properties - Version 1.01                    Page 13
  916.  
  917.  
  918.  
  919.        The only restriction on distribution is that we ask that you always
  920.        give away copies of the full system with all its files, and that
  921.        they are not modified in any way.  The full list of files is given
  922.        in the section on Installation and Startup at the beginning of this
  923.        manual.
  924.  
  925.        Suppliers of hardware and software may bundle WASP with any of their
  926.        other products, subject to the above restriction, and that it is
  927.        clearly stated that any payment made is solely for the other product
  928.        and not for WASP.
  929.  
  930.  
  931.        Registration to Engineering Schools
  932.        -----------------------------------
  933.  
  934.        Any University or Technical College involved in the tertiary
  935.        education of engineers can obtain a licence for WASP free of charge. 
  936.        In order to get your registered copy of the latest version please
  937.        fill in the registration questionnaire in the normal way and get
  938.        your Head of Department to write a covering letter on your School's
  939.        official letterhead, but send NO MONEY.
  940.  
  941.        All that we ask in return is that you make the registered copy
  942.        available to all students and staff so that we do not get duplicate
  943.        requests, and hopefully the students will take their copies with
  944.        them when they go out into industry.
  945.  
  946.  
  947.        Bug Reports and Wish Lists
  948.        ==========================
  949.  
  950.        We have put many hours into the checking of this programme and were
  951.        not aware of any bugs at the time of release.  However, we are also
  952.        aware that the most subtle bugs are unearthed after release.  We are
  953.        therefore most grateful to those who report bugs to us.  Please give
  954.        as much detail as possible on the bug so that we can re-create the
  955.        circumstances on our equipment.  Please include details of your
  956.        hardware, operating system, resident programmes and so on.
  957.  
  958.        Our experience gained over many years and with the development of
  959.        several packages has shown us that no matter how much effort we put
  960.        into designing and planning we can never hope to match the combined
  961.        creativity of our users.  We would like to hear of any features you
  962.        would like to see changed or added to WASP.  Are there units that
  963.        you use that we have not built in ?  Let us know and if they are
  964.        anything more reasonable than bathtubs/fortnight we will build them
  965.        in.  Are there standard calculations that you would like built in ? 
  966.        If so please send details and samples.  Would you like to be able to
  967.        use WASP on operating systems other than DOS ?  Are there any
  968.        operations in WASP that are awkward and not intuitive or standard ? 
  969.        Let us know how you would prefer it to be.  (We know of a word
  970.        processor package that refused to put the Help key on <F1> until
  971.        they got to version 6 !  Hopefully we can be more responsive than
  972.        that.) 
  973.  
  974.  
  975.  
  976.        Water and Steam Properties - Version 1.01                    Page 14
  977.  
  978.  
  979.  
  980.        Other Engineering Packages from Katmar Software
  981.        ===============================================
  982.  
  983.        Our aim at Katmar Software is to provide top quality process
  984.        engineering utility software at realistic prices.  WASP is the first
  985.        of our packages to be released.  Other applications that we have in
  986.        various stages of development between conceptual design and beta
  987.        testing are more physical property database and estimation packages; 
  988.        flow calculations in pipes, valves and orifices;  process equipment
  989.        design and evaluation programmes and so on.
  990.  
  991.        As soon as these packages are released as shareware we will advise
  992.        all registered users of WASP.  If there are particular application
  993.        areas where you have a need for low cost utilities please let us
  994.        know as we would like to focus our limited resources where they will
  995.        be most effective.
  996.  
  997.  
  998.  
  999.        Appendix
  1000.        ========
  1001.  
  1002.  
  1003.        WASP Registration Form
  1004.        ----------------------
  1005.  
  1006.        The following registration form is provided for those who would like
  1007.        to fill in their order form manually.  You can also complete the
  1008.        registration form by loading the file REGISTER.DOC into your word
  1009.        processor and filling in the missing information before printing it
  1010.        out.  Probably the easiest way to register is to run the WASP
  1011.        programme and press <Alt R> at the Shareware Distribution Screen. 
  1012.        The programme will ask you the questions and you can type your
  1013.        information directly into the programme.  It will then print out the
  1014.        registration form on your printer.
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.        Water and Steam Properties - Version 1.01                    Page 15
  1038.  
  1039.  
  1040.  
  1041.                                        I N V O I C E
  1042.                                        =============
  1043.  
  1044.                                       Katmar Software
  1045.                           PO Box 654, Westville, 3630, South Africa
  1046.  
  1047.                                                  Date : ...................
  1048.  
  1049.             Ordered By :-                        Order Number : ...........
  1050.             -------------
  1051.  
  1052.                Name : ..................................................
  1053.  
  1054.                Job Title : .............................................
  1055.  
  1056.                Department : ............................................
  1057.  
  1058.                Company : ...............................................
  1059.  
  1060.                Address : ...............................................
  1061.  
  1062.                          ...............................................
  1063.  
  1064.                Town :    ...............................................
  1065.  
  1066.                State : .................................................
  1067.  
  1068.                Postal / ZIP Code : .....................................
  1069.  
  1070.                Country : ...............................................
  1071.  
  1072.  
  1073.  
  1074.             
  1075.             Supply :-   ( please delete as appropriate )
  1076.             ---------
  1077.  
  1078.                1 copy of WASP (single user licence) at US$40-00
  1079.                1 copy of WASP (multi-user site licence) at US$75-00
  1080.  
  1081.               The single-user licence allows you to install the programme
  1082.               onto several different computers belonging to the same
  1083.               organisation and on the same premises, but only one copy
  1084.               may be run at a time.  If there is a likelihood that the
  1085.               programme will be run simultaneously on two or more
  1086.               machines we ask that you purchase a multi-user site licence.
  1087.  
  1088.  
  1089.                                            SUM Enclosed : US$ .............
  1090.  
  1091.             Enclose a cheque or money order for the above amount. No
  1092.             purchase orders or COD's will be accepted.  If ordered from
  1093.             within the South African monetary area payment may be made in
  1094.             Rands at the current exchange rate.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                   Additional Information
  1100.                                   ----------------------
  1101.  
  1102.             My telephone number is : .....................................
  1103.  
  1104.             My FAX number is : ...........................................
  1105.  
  1106.             My company's main business is : ..............................
  1107.  
  1108.  
  1109.             As a Shareware distributor we rely heavily on others to do our
  1110.             "marketing" for us.  We would therefore greatly appreciate you
  1111.             giving us the following information so that we can ensure that
  1112.             the good folks doing our marketing can be kept supplied with
  1113.             the latest versions of the programmes.
  1114.  
  1115.             How did you obtain your evaluation copy of WASP ?
  1116.  
  1117.             Tick one of the following :-
  1118.                  .... Friend / Associate
  1119.                  .... User Group / Computer Club
  1120.                  .... Shareware Disk Distributor
  1121.                  .... Bulletin Board
  1122.                  .... Other ( Please specify .............................)
  1123.  
  1124.             Address of source of evaluation copy (if known)
  1125.  
  1126.             ..............................................................
  1127.  
  1128.             ..............................................................
  1129.  
  1130.             ..............................................................
  1131.  
  1132.             ..............................................................
  1133.  
  1134.             ..............................................................
  1135.  
  1136.             ..............................................................
  1137.  
  1138.  
  1139.             The version number of my evaluation copy is .................
  1140.             and it was registered to :-
  1141.  
  1142.             .............................................................
  1143.  
  1144.  
  1145.             Our experience has shown us that no matter how much thought and
  1146.             effort we put into designing our software, we can never design
  1147.             as good a programme as our users can.  We therefore greatly
  1148.             appreciate your input on what are the good and bad points of
  1149.             WASP.  If there is insufficient space on the following page
  1150.             please feel free to add in extra sheets of paper.
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.             What aspects of WASP do you like least and how would you like
  1157.             to see them improved ? :-
  1158.  
  1159.             ..............................................................
  1160.  
  1161.             ..............................................................
  1162.  
  1163.             ..............................................................
  1164.  
  1165.             ..............................................................
  1166.  
  1167.             ..............................................................
  1168.  
  1169.             ..............................................................
  1170.  
  1171.             ..............................................................
  1172.  
  1173.  
  1174.             What facilities would you like to see added to WASP ? :-
  1175.  
  1176.             ..............................................................
  1177.  
  1178.             ..............................................................
  1179.  
  1180.             ..............................................................
  1181.  
  1182.             ..............................................................
  1183.  
  1184.             ..............................................................
  1185.  
  1186.             ..............................................................
  1187.  
  1188.             ..............................................................
  1189.  
  1190.  
  1191.             Do you have any other general comments ? :-
  1192.  
  1193.             ..............................................................
  1194.  
  1195.             ..............................................................
  1196.  
  1197.             ..............................................................
  1198.  
  1199.             ..............................................................
  1200.  
  1201.             ..............................................................
  1202.  
  1203.             ..............................................................
  1204.  
  1205.             ..............................................................
  1206.  
  1207.  
  1208.                      Thank you very much for your order 
  1209.                      and for providing this information.
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.